home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 March / macformat-022.iso / Shareware City / Info / mod-file-solutions.txt < prev    next >
Encoding:
Internet Message Format  |  1994-11-22  |  36.2 KB  |  [TEXT/unix]

  1. From: kylea@INS.INFONET.NET
  2. Date: Wed, 09 Nov 1994 09:39:20 CST
  3. Subject: .MOD file info summary
  4.  
  5. Hello fellow netters!
  6.  
  7. Long ago I promised a summary posting of suggestions and info regarding my
  8. request for
  9. information on the .MOD file format on the Macintosh. Well, I finally have
  10. prepared
  11. one. I realise that this is a frequent question and that this response may be
  12. over-
  13. due, but better late than never.
  14.  
  15. I will post the replies I received here.  Those recommending SoundTrecker:
  16.  
  17. get the newest version of the soundtrecker.
  18. its great!
  19. and shareware
  20. ciao    kp <klaus-peter gores>
  21.  
  22. also <Alan Piszcz>
  23.  
  24. Try a program called SoundTrecker.. It's a German program redone in
  25. English, but is quite good. It even lets you perform surround sound effects
  26. on MOD files, as well as the requisite save to disk as Sys7 sound.
  27.  
  28. It should be in either Info-Mac or Umich archives.. if you have trouble
  29. locating it, let me know and I'll mail it to you!
  30.  
  31. Joel Moses
  32. WSMV-TV (NBC)
  33. jmoses@edge.ercnet.com
  34.  
  35. There is a shareware called "the Sound-Trecker" that can
  36. play .MOD files on the Mac. If you cannot find it on
  37. a ftp site, I can email you a copy.
  38. Where do you get .MOD files?
  39.  
  40.             Louis <Louis Moreau>
  41.  
  42. Try Sound-Trecker. It's avaliable at most mac ftp sites, or email me and
  43. I'll sen it to you (230k).
  44.  
  45.         adamf@isx.com (Adam Fouse)
  46.         
  47. Try Sound Trecker 2.2. It is EXCELLENT.
  48.  
  49. It is available in the sounds/utilities folder of your favourite Info-Mac
  50. mirror site. The path once inside info-mac is:
  51.  
  52. /info-mac/snd/util/sound-trecker-22.hqx
  53.  
  54. Have a nice day :-)
  55.  
  56. Any trouble? Let me know.
  57.  
  58. Arthur Day, Electron Microscopy Group
  59. Ansto Advanced Materials Program                        Phone: 61-2-717-3457
  60. PMB 1,  Menai (Sydney), NSW, 2234                        Fax: 61-2-543-7179
  61. Australia
  62. Email: ard@atom.ansto.gov.au
  63.  
  64. Try Sound-Treker its available from many sites. It seems pretty good and
  65. can read many .MOD formats at various sampling rates. It seems pretty
  66. good. I have a copy on a CD at home if you can't find it in the archives
  67. just drop me a line and I'll bin-hex it to you.
  68.  
  69. Regards Ralph Buckley                     Baldrige Silver Project Manager
  70.                                               Customer Satisfaction Group
  71. BUCKLR at UKSSVM1 / GBIBMZGZ at IBMMAIL          ISSC Service Delivery
  72. Ralph@vnet.ibm.com                               PO BOX 41, North Harbour
  73.                                                  PORTSMOUTH, Hampshire
  74. Int:(7)255504 / Ext:(0705) 565504                UK, PO6 3AU.
  75. _________________________________________________________________________
  76.  
  77. Standard Disclaimer: These are my comments; not the views of IBM-ISSC.
  78.  
  79. X-MX-Comment: QUOTED-PRINTABLE message automatically decoded
  80.  
  81. Hi there... What you are looking for is a program called THE SOUND TRECKER, a
  82. beautiful nifty interfaced .mod player for the mac. (if you are lucky enough to
  83. own a PowerMac, you'll be pleased to know it comes with it's own PowerPlug, to
  84. take adv
  85. The program is definitely in SUMEX. I have version 2.2, and I believe it's the
  86. latest. I'm sure you'll get loads of mail telling you to get Player Pro, but I
  87. recommend The Sound Trecker instead.. It is not only faster, but niftier.
  88.         Enjoy...!
  89.  
  90. Cheers,
  91. CRISTIAN
  92.  
  93. aviola@conicit.ve (Agustin Viola)
  94.  
  95.  
  96. Hi,
  97.  I have a utility called sound Trekker which plays amiga mods. If you
  98. haven't sorted your problems out by the time you get this then drop me a
  99. line and I will post it to you.
  100.  
  101.  
  102. Cheers,
  103.  
  104.  
  105. Rob. \\//
  106.  
  107. Public service announcement: This signature file is under construction....
  108. ******************************************************************************
  109. * Confused? You Will be! * Okay here's the way to contact me,if you want to! *
  110. * Sodomy non sapiens..   *    w.r.brady@ncl.ac.uk is for email..             *
  111. * Oh No, another boring  *    +44 (0)91 266 8998, answered as Digital Domain *
  112. * signature file..Ho Hum *    +44 (0)91 266 9995, for faxes and stuff..      *
  113. ******************************************************************************
  114. ... and normal service will be resuming shortly, just like British Rail ;-)
  115.  
  116.  
  117. *****The following posts were more detailed than most. Note that the
  118. overwhelming
  119. response was in favor of SoundTrecker. I liked Player Pro and SoundTrecker --
  120. try
  121. both and see which is better for your situation.  Thanx again for all the help
  122. everyone.  Cheers!
  123.  
  124. ====
  125.  
  126. There are a couple of MOD players for Macintosh.  The one I like best is
  127. The Player Pro, which you can find at:
  128.  
  129. ftp://sumex-aim.stanford.edu/info-mac/snd/util/player-pro-42.hqx
  130.  
  131. The other one I've looked at is called Sound Tracker.  It seems to work
  132. well; I just like The Player Pro better.
  133.  
  134. I don't know if you can easily convert a .MOD file to a snd file.  As
  135. SoundApp's documentation states, MOD files are not sound files, but music
  136. files.  A MOD player will take relatively short sound samples in a .MOD
  137. file and play them according to the pitch and sequence score also stored in
  138. the file.  By using this method, you can produce several minutes of music
  139. from a very small file.  If you could convert this to a snd file (strictly
  140. a sample, with no sequence information), the result could take up an
  141. enormous amount of disk space.
  142.  
  143. I hope this helps.  If you want to find out more about music file formats,
  144. try looking at:
  145.  
  146. ftp://sumex-aim.stanford.edu/info-mac/info/music-file-formats-10.hqx
  147.  
  148. Bill Cameron                                       sdg
  149. camerowd@picard.ml.wpafb.af.mil
  150. billc55122@aol.com
  151.  
  152. ====
  153.  
  154. regarding your questions about .MOD files in the info-mac digest,
  155. (also C.S.M.D? I don't have Usenet access :-( )
  156.  
  157. SoundApp converts only the samples in a mod file, not the wholr
  158. song.  SoundApp plays the MODs with routines borrowed from Sound
  159. Trecker. Sound Trecker will play the MODs just the same way, but
  160. with a better IMHO interface, and will also convert them to AIFF,
  161. SYS7, and Soundmover? suitcases, or such... anyway, a few different
  162. formats. and with sampling of 11 to 44 Khz and 8 or 16 bits and
  163. stereo or not. if you don't know about all that stuff, the higher
  164. each of the settings is, the better it sounds, and the more it
  165. fills up your hard drive :-)
  166.         you might want to just keep them as MODs, though, they
  167. take up a few megs apiece as SYS7 sound files. as MODs, they are
  168. just a bunch of samples, and instructions on what to do with them,
  169. so they are very small. The Sound trecker is available on info-mac
  170. in the sound or sound/util folder, I'm not sure which. hoe this
  171. helps. TTYL
  172. -- 
  173. Jim "Chr0med Aardvark" Russell of Regina, Saskatchewan, Canada
  174. Internet: jrussell@unibase.Unibase.SK.CA
  175.  
  176. =====Player Pro info.
  177.  
  178. From: jamal@bronze.lcs.mit.edu (Jamal Hannah)
  179. Message-ID: <199409212114.RAA24231@bronze.lcs.mit.edu>
  180. To: kylea@INS.INFONET.NET
  181. Subject: playerpro-info.txt (this is a little old.. sorry..)
  182.  
  183. THE PLAYER PRO DEMO INFORMATION FILE (FAQ)
  184. by Jamal Hannah <jamal@gnu.ai.mit.edu>, 6/21/94, version 1.21
  185. -------------------------------------------------------------
  186. CONTENTS:
  187.  
  188. * What is the Player PRO Demo?
  189. * What is the latest version of Player PRO?
  190. * What are the features of Player PRO?
  191. * What Hardware do I need to run the Player PRO?
  192. * Where can I get the Player PRO?
  193. * What Software do I need to run the Player PRO?
  194. * What are MOD files?
  195. * What file format is native to Player PRO?
  196. * What do I need to do to make my own MOD files?
  197. * Where can I find MOD files?
  198. * How do I go About Writing MOD-Playing Code?
  199. * How do I Register the Player PRO so I can Edit MOD files?
  200. * What do I do if I cant get the Player PRO to work?
  201. * What other programs for the Macintosh play or Edit MOD files?
  202. * Seeking further technical information.
  203. * Electronic Mailing-List Address
  204.  
  205.  
  206. WHAT IS THE PLAYER PRO DEMO?
  207.  
  208. "The Player PRO" is a shareware music/soundtrack file player and
  209. editor for the Apple Macintosh.  The version available on public FTP
  210. sites and BBS systems is a _DEMONSTRATION_ version and does not have editing,
  211. and some other capabilities activated, and is commonly known as the "BBS"
  212. archive.
  213.  
  214.  
  215. WHAT IS THE LATEST VERSION OF THE PLAYER PRO?
  216.  
  217. As of June 9, 1994, the latest version of the Player PRO is version
  218. 4.15(6)  (Released: 6/6/94)
  219.  
  220. In some erlier versions of The Player PRO, it's hard to tell exactly what
  221. version it is, because in some places it will say one version number, and
  222. in other places it will say another.  The best way is probabaly to check the
  223. version in the "Get Info" window, in the Finder.  (Though even this may
  224. not be reliable... just look at all the different version numbers and try
  225. to find the latest one.)
  226.  
  227.  
  228. WHAT ARE THE FEATURES OF THE PLAYER PRO?
  229.  
  230. A registered version of the Player PRO can currently import and play music
  231. module files of the following types:
  232.  
  233. Amiga SoundTracker 4 voice, 15 instrument
  234. Amiga NoiseTracker 4 voice, 31 instrument (M.K. signature)
  235. Amiga ProTracker 4 voice, 31 instrument, 64 pattern (M.K. sig.)
  236. Amiga ProTracker 4 voice, 31 instrument, 128 pattern (M!K! sig)
  237. Amiga Star Tracker (StarTrekker) 4 voice (FLT4 sig)
  238. Amiga Star Tracker (StarTrekker) 8 voice (FLT8 sig) [Not tested]
  239. Amiga Oktalyzer 4-8 voice [beta]
  240. IBM FastTracker (ver 1.0) 6 & 8 voice (6CHN, 8CHN sig)
  241. Macintosh MADF 1-16 voice, 8 bit instruments (Player PRO ver 4.1x? - 4.154)
  242. Macintosh MADG 1-32 voice, 16 bit instruments (Player PRO ver 4.155 - ?)
  243.  
  244. The Player PRO does not yet properly import the following music formats:
  245. MIDI, IBM 669 ("Composd" editor), IBM ScreamTracker 3.0 (S3M),
  246. Amiga MED/OctaMED, and IBM Multi-Tracker Module (MTM), but these
  247. are being worked on!
  248.  
  249. Note: The "FastTracker 1.0" 8-channel module type is actualy identical
  250. to IBM GraveMod (.WOW files with "M.K." sig), and at least two 8-track
  251. Atari STe formats ("FA08" and Octalyser's "CD81").. one simply needs to
  252. change the 4-byte signature at position 1080 in the file to "8CHN" in
  253. order to import them with Player PRO.
  254.  
  255.  
  256. WHAT HARDWARE DO I NEED TO RUN THE PLAYER PRO?
  257.  
  258. The Player PRO will run on any Apple Macintosh with an Apple Sound Chip
  259. (ASC) in it, or possibly a non-ASC Macintosh with System 7.1 and
  260. Sound Manager 3.0 extension. (System 7.2 and above have Sound Manager 3.0
  261. built-in) This includes the Mac SE/030 and the Mac LC, though they probably
  262. do not have performance which is as good as machines like the Macintosh
  263. Quadra family, or the AV series.
  264.  
  265. The Player PRO also works on the Power PC series, and has a "FAT" binary
  266. code block in the data-fork for this purpose. The data fork contents can be
  267. deleted by those who do not have a Power PC and wish to save some disk space.
  268.  
  269.  
  270. WHERE CAN I GET THE PLAYER PRO?
  271.  
  272. The Player PRO version 4.15x is available from FTP site
  273. sumex.stanford.edu, in directory path: /info-mac/snd/util
  274. or these info-mac mirror sites:
  275. wuarchive.wustl.edu in path: /systems/mac/info-mac/snd/util
  276. ftp.hawaii.edu in path: /mirrors/info-mac/snd/util
  277.  
  278. As well as:  mac.archive.umich.edu, path: /mac/sound/soundutil
  279.  
  280. The file name (often) is: player-pro-415x-demo.hqx  (stored in Stuffit
  281. Lite/Stuffit Delux format, and encoded with BinHex 4.0)
  282.  
  283.  
  284. WHAT SOFTWARE DO I NEED TO RUN THE PLAYER PRO?
  285.  
  286. All versions of the Player PRO need System Software that takes
  287. advantage of the Apple Sound Chip.  This includes system version
  288. 6.0.5 to 6.0.8, but is better implemented in System 7.0 and 7.1.
  289. however, none of these contain the specific information for using
  290. the Player PRO's current capabilities optimally.. you need
  291. "Sound Manager 3.0" _and_ "System 7.1" specificly for this.
  292. The Sound Manager 3.0 extension (as well as an enhanced Sound Control
  293. Panel, version 8.0.1) is available via FTP at ftp.apple.com, in the file:
  294. system-update-2-0-1-image.hqx, in directory path:
  295. /dts/mac/sys.soft/7.system.updates.  The file must be
  296. downloaded in ASCII mode, unless you have an automatic BinHex converter.
  297. You must then un-BinHex the file, and then use the utilities called
  298. "MountImage" (a Control Panel) or "DiskCopy" (an application), both from
  299. Apple, in order to access the *.image file  (the file will have to be
  300. decompressed first.)
  301.  
  302. If you don't have System 7.1 with Sound Manager 3.0, the sound quality
  303. will depend completely on the performence of the Apple Sound Chip and
  304. specialized routines that Player PRO uses for it, rather than standard
  305. routines from Apple Computer.
  306.  
  307. Once you install the Sound Manager Extension, reboot your machine, and
  308. launch Player PRO.  Go to the "Preferences" menu selection and set it
  309. to use the "mono" Sound Manager 3.0 routines if you don't have your
  310. Mac connected to a stereo.  This will significantly reduce problems
  311. with the software, though it may run slower than it would with the
  312. specialized, hardware-accessing sound routines.  Also, make sure you
  313. turn on the "32-bit addressing" mode, in the "Memory" control panel
  314. before running the latest version of Player PRO.
  315.  
  316. A Wish List:
  317.  
  318. All of the above is of course a lot of trouble.  It would be nice if
  319. Antoine would add to the "Preferences" the option to use some
  320. "Sound Manager 2.0" playing code, for use on non-32-bit-clean Macs running
  321. system software erlier than 7.1.  (The shareware program "MacTracker 1.2"
  322. has source code like this)  It would be even nicer if Antoine would
  323. also include "Sound Driver/Sound Manager 1.0" routines, for the very old,
  324. pre-ASC Macintoshes to be able to use The Player PRO!  (in Black and White,
  325. with a small screen, of course.)
  326.  
  327. If you have a wish list of your own, feel free to contact Antoine Rosset
  328. in email or with a fax, and suggest it to him.
  329.  
  330. A Note About Bugs:
  331.  
  332. Player PRO currently crashes if you attempt to "Import S3M" (IBM
  333. ScreamTracker 3.0 MODs), so don't bother with it. (this will only
  334. work in version 4.155 for now)  IBM FastTracker 8-voice
  335. MODs load and play fine, however.  (Though you may run out of memory)
  336. An actual 8-voice Amiga "StarTrekker" MOD file has not been tested yet,
  337. but 4-voice StarTrekker (also called "Star Tracker" v 1.2) play fine.
  338.  
  339. Player PRO will force mod files from other Mac programs which
  340. _already_ have an icon to have a Player PRO icon when it plays them.
  341. You may or may not want this to happen. (too bad it isn't optional..)
  342.  
  343. Sometimes the icon for the Player PRO 4.15x application will look like
  344. the icon from "The Player II", even on a color screen.  But it
  345. also may look like a colorful Compact Disk... I have no idea why it is
  346. sometimes one or the other.
  347.  
  348. Files do not always repeat correctly if they have a "pattern jump"
  349. command at the very end.. also, there are problems with modules
  350. that do not set the speed in the beginning: if they repeat, and the
  351. speed has been altered, they will replay at this new faster or slower
  352. playing speed!
  353.  
  354. The editor actualy displays octave ranges C2-B6, though MOD files
  355. use octave ranges of C1-C3 (extended versions use C0-C4).  This does not
  356. seem to effect pitch playback quality, however.  The General-MIDI and XTracker
  357. formats support up to 9 full octaves!
  358.  
  359.  
  360. WHAT ARE MOD FILES?
  361.  
  362. "MOD" files, also called "music modules", or "soundtrack" files, were
  363. originally created on the Amiga computer by a man named Karsten Obarski,
  364. in a program called "SoundTracker".  They were intended to be compact
  365. ways of storing music inside games and demos, especially background music.
  366. The files consist of "patterns" of musical notes inside "partitions"
  367. (pattern lists) which can be played in different order, and more than once.
  368. (Note: the term "pattern" sometimes refers to a single set of 4 notes &
  369. commands in a 4-voice module, or sometimes to an _entire_ pattern list
  370. (partition) of 64 patterns.)
  371.  
  372. The musical notes are played as sampled sounds which are stored at the end
  373. of the MOD file.  The sounds are played back at different pitches to give
  374. the effect of a real musical instrument or synthesizer.
  375. (Note: The term "sample" sometimes refers to a single byte inside
  376. an 8-bit digitized sound, and sometimes to the _entire_ digitized
  377. sound (intrument or "patch".)
  378.  
  379. Simmilar "memory dump" formats were written by Amiga programmers like
  380. Armin Sander (Oktalyzer), and Teijo Kinnunen (MED), though later they were
  381. changed both to something more extensible. (see below)
  382.  
  383. The origional SoundTracker format was later extended by "Mahoney and Kaktus"
  384. of Switzerland in an Amiga program called "NoiseTracker", and later even
  385. further extended in "ProTracker" by Lars "ZAP" Hamre (PT 1.1),
  386. Peter "CRAYON" Hanning (PT 2.3A), and eventualy various members of
  387. an Amiga coding group called "CryptoBurners".  Version 3.10 or 3.15
  388. is the current version of ProTracker for the Amiga.
  389.  
  390. Since the origional version of the MOD format spec, there have been many
  391. new types of MOD file, some simply adding more patterns so the MODs could
  392. hold more "voices", while others added more effects.  These types include
  393. Star Tracker, Oktalyzer, and OctaMED on the Amiga, and GraveMod (WOW modules),
  394. FastTracker 1.0, ScreamTracker 2 & 3.0, Farandole, MultiTracker,
  395. XTracker (DMF modules), TakeTracker (almost identical to FastTracker 1.0),
  396. and UltraTracker on the IBM.
  397.  
  398. Newer, more advanced and flexible module formats are always being written,
  399. and future version of the IBM "ScreamTracker" and "FastTracker" programs
  400. will have completely new, extended formats.
  401.  
  402.  
  403. WHAT FILE FORMAT IS NATIVE TO PLAYER PRO?
  404.  
  405. The module format that The Player PRO currently uses is called "MAD",
  406. and is commonly referred to as "MADF", though a newer, extended version
  407. with the internal signature "MADG" is now being used.
  408.  
  409.  
  410. WHAT DO I NEED TO DO TO MAKE MY OWN MOD FILES?
  411.  
  412. In order to edit your own MOD music files on the Macintosh, you need to
  413. register the Player PRO Demo so that the editing capabilities can be
  414. activated.  Also, you need specific information about the internal
  415. structure of MOD files, as well as the different musical effects "commands"
  416. which you can use within the MOD.  This information is available on
  417. FTP site sumex.stanford.edu, in the files "mod-info.txt" and
  418. "mod-form.txt", both of which reside in directory path
  419. /info-mac/sound/util, or on the mirror site wuarchive.wustl.edu
  420. in /systems/mac/info-mac/sound/util.  You _must_ have these files,
  421. or something else with similar information, because most MOD editors
  422. (Sound Trackers) are not like traditional music composition software,
  423. and they do not rely on placing notes on a musical staff.  (which would
  424. be far more intuitive.)  Rather, the user must edit the patterns directly.
  425. The Player PRO npw offers a limited form of "Classical Partition" editing,
  426. which is a step in the right direction.
  427.  
  428. Some helpful information for editing MOD music would be in the
  429. "LESSON_1.TXT" file by Per Almered of Sweden, which origionaly
  430. came with an Atari STe 8-track module-editor called "Octalyser".
  431. This is available with it's accompanying module on info-mac ftp sites.
  432. (info-mac/info/sft/mod-editing-lesson.hqx).
  433.  
  434. Also, the electronic magazine called "SIGNALS" has some very valuable
  435. information about editing mods, by an IBM programmer called "Necros",
  436. at email address: <segaag@craft.camp.clarkson.edu> (this address
  437. seems to be out of date)... "Necros" and other IBM music programmers
  438. and composers can sometimes be found on Internet Relay Chat (IRC),
  439. in channel "#coders".
  440.  
  441. It might also be a good idea to have the Mac shareware utility "HexEdit"
  442. (System 7 only), which is great for editing the data inside a Macintosh
  443. file data fork.
  444.  
  445.  
  446. WHERE CAN I FIND MOD FILES?
  447.  
  448. If you simply want to play MOD files, a good place to look is the aminet
  449. FTP site.  You will need the Macintosh utility "MacLHA" in order to
  450. decompress archive files with names that end in ".lzh" and ".lha".
  451. Aminet's FTP address is: wuarchive.wustl.edu  path:
  452. /systems/amiga/aminet/mods
  453.  
  454.  
  455. HOW DO I GO ABOUT WRITING MOD-PLAYING CODE?
  456.  
  457. You can get source code for playing MOD files several different ways.
  458. Antoine Rosset's MADF module playing libraries are available in info-mac
  459. as a developer package.  Frank Seide's Sound-Trecker MOD-playing routines
  460. are available at the same location.  Tom Lawrence & Marc Espie's Macintosh
  461. Tracker source code is also available.  Other source-code tends to be in
  462. Amiga 68000 Assembly, or IBM C & Pascal (or assembly) source.  The other
  463. thing you will need, of course, is the format specification for
  464. the type of module files you wish to play.  (This is available in
  465. a Macintosh "UnZIP 2.0.1" archive file called "MUSFMTxx.ZIP",
  466. or on info-mac FTP sites as: info-mac/info/music-file-formats-xx.hqx)
  467.  
  468. A good module for testing a MOD player is "shadfant.mod" ("Shaded Fantasy"),
  469. by "mub" of "lsd".. Most mod players can't play it correctly, but it _is_
  470. a ProTracker module, written in 1991.  [info from "Sungod" on IRC]
  471.  
  472.  
  473. HOW DO I REGISTER THE PLAYER PRO?
  474.  
  475. The Player PRO's shareware fee is $20 US money.  The author would
  476. like cash sent to him, or money transferred to his postal account
  477. (number = 12-34943-1), or a transfer to his bank (Societe de
  478. Banque Suisse, SBS) account (number = D1-107.121)
  479.  
  480. If you must send a check, add $15  (total: $35)
  481.  
  482. The author's address is:
  483.  
  484. Antoine Rosset
  485. 16 BD Tranchees
  486. 1206 GENEVA
  487. SWITZERLAND
  488.  
  489. Internet email: arosset@perokcity.net.ch or 100277.164@compuserve.com
  490. Compuserve email: 100277,164
  491. Fax: (41 22) 364 11 97
  492. BBS: First Class, 2400-14400baud, (41 22) 320 11 95, User ID: ROSSET Antoine
  493.  
  494. If you send email to Antoine Rosset, expect 1-2 weeks for him to reply.
  495. The same goes for fax orders.  If you send him regular mail, it's
  496. likely to be 2-3 weeks or so before you receive a diskette.
  497.  
  498.  
  499. WHAT DO I DO IF I CANT GET THE PLAYER PRO TO WORK?
  500.  
  501. If the program crashes, be sure to note the machine you are using, the
  502. system software version, how much memory you have (RAM), what sort of
  503. extensions and control panels you are running that are not from Apple,
  504. and what exactly it was that you did just before the crash, and what sort
  505. of error it gave you.  Send this information to Mr. Rosset, and he will
  506. work to correct the problem and get a bug-fixed version to you.
  507.  
  508.  
  509. WHAT OTHER PROGRAMS FOR THE MACINTOSH PLAY AND EDIT MOD FILES?
  510.  
  511. Currently, the Player PRO is the only Macintosh program that edits Amiga
  512. MOD files.  There is a commercial program for the Macintosh called
  513. "Super Studio Session" which edits and plays files somewhat similar to
  514. MODs, and it works on non-ASC Macintoshes too! (Like the Mac Classic)
  515.  
  516. There is a non-shareware product for producing General-Midi musical
  517. soundtracks for games, etc., called "Halestorm", by Steve Hales, of
  518. Halestorm, Inc. <hales@netcom.com>.  This product was used for the
  519. music in games such as: SimCity 2000, Lemmings for the Mac, and
  520. Disney After Dark.
  521.  
  522. QuickTime 2.0 will be able to support Midi-style "music tracks".
  523.  
  524. Some other shareware programs that play MOD files on the Mac:
  525. -------------------------------------------------------------
  526. SoundApp 1.1, by Norman Franke <franke@jedi.llnl.gov>
  527. The Sound-Trecker 2.0.1, by Frank Seide <seide@pfa.philips.de>
  528. MacTracker 1.2, by Thomas R. Lawrence <tomlaw@world.std.com>
  529. -------------------------------------------------------------
  530.  
  531. HyperCard shareware MOD Players:
  532. --------------------------------
  533. MusicBox XCMD 2.1, by Alex Metcalf <alex@metcalf.demon.co.uk>
  534. PlayMOD 1.1, by K. Harris <SPerspect@aol.com>
  535. -------------------------------------------------------------
  536.  
  537. If someone would write a Macintosh MOD player for the Mac Plus, that would
  538. be great.  There are ways to squeeze up to 8 "voices" out of the original
  539. Mac, but it takes some fancy waveform mixing while the file is playing.  It
  540. would also use older Sound Manager or Sound Driver routines.
  541.  
  542. Note: Macintosh mod-players tend to support instrument samples larger
  543. than 64K (mabye up to 128K), but mod-players on other systems often
  544. do not.  If you want your exported MOD file to be playable on as many
  545. systems as possible, make sure your instruments are not too big!
  546. (the smaller the better.  A "ChipTune" is a module with instruments that
  547. are generaly under 1024 bytes in length!
  548.  
  549.  
  550. SEEKING FURTHER TECHNICAL INFORMATION
  551.  
  552. In addition to the people listed above, following people seem to know a lot
  553. about music related programming on the Macintosh:
  554.  
  555. Joe Zobkiw <zobkiw@datawatch.com>
  556. Bill Williams <bwilliam@holonet.net>
  557. Jim Reekes <reekes@applelink.apple.com>
  558.  
  559. Another person with lots of info about module-formats is Harald Zappe
  560. <zappe@gaea.sietec.de>, an IBM programmer, and Peter Kunath
  561. <kunath@informatik.tu-muenchen.de>, an Amiga programmer.
  562.  
  563. Please write to me (jamal@gnu.ai.mit.edu> if you know a lot about Macintosh
  564. music and sound programming and can help other programmers.
  565.  
  566.  
  567. ELECTRONIC MAILING-LIST
  568.  
  569. If you need more info, join the Player PRO Electronic Mailing List,
  570. by sending email with your name and preferred email address to:
  571.  
  572. pp-users-request@gnu.ai.mit.edu
  573.  
  574. (This is not the actual address of the list, but rather a seperate
  575. address for sending personal email-address add/drop requests...
  576. please don't use the actual list address for personal messages
  577. to the list moderator!  The list is not automated.)
  578.  
  579. Antoine is on this list, along with several other Mac mod-player
  580. programmers, so your comments will be heard by them.
  581. ------------------------------------------------------------------------------
  582.  
  583. Subject: mac-mod-info (old too)
  584.  
  585. MOD Players for the Macintosh
  586. 11/8/93 Release, by Jamal Hannah <jamal@gnu.ai.mit.edu>
  587.  
  588. Yes!  There are Mod players for the Mac!  All of them can be
  589. found on FTP site sumex.stanford.edu in /info-mac/snd/util
  590. or wuarchive.wustl.edu in /mirrors/info-mac/snd/util
  591.  
  592. Name        Vers    Author        Edits?    Note
  593. -----        ----    -------        ------    -----
  594. Sound-Trecker    2.0    Frank Seide    no      The De Facto Mac Mod player.
  595. AlphaTrecker    2.0    Fred Condo    no    Plays MOD at startup
  596. MOD Voicer    1.1    Kip Walker    no    Utility to rip samples from mod
  597. The Player II    2.5    Antoine Rosset    no    Same playing code as S. Trecker
  598. Mac Tracker    1.00    Thomas Lawrence    no    Slow.  Plays some thing ST wont
  599. Player Pro beta    4.09    Antoine Rosset    yes    Editor! (Limited in beta.)
  600.  
  601. "The Sound-Trecker" was origionaly in German but called "SoundTracker"..
  602. it comes with source code and compiled modules for playing some mods.
  603.  
  604. SoundTrecker's name is of course derived from the Amiga "SoundTracker"
  605. program.  It isnt a "true" tracker though, because it does not edit
  606. MODs!  (It's an annoying trend to see all these players called "trackers".)
  607.  
  608. AlphaTrecker 2.5 and The Player II both use Frank Seide's MOD playing code,
  609. so the playing quality is much the same.
  610.  
  611. "Mac Tracker" and "Player Pro" play many mods that those programs do not,
  612. but some mods that don't work with Mac Tracker or Player Pro work on
  613. Sound Trecker/Player II.  Go figure.
  614.  
  615. The Player Pro is a beta version, and does not let you create new partitions
  616. when you are editing a MOD, nor can you import MIDI (.MID) files,
  617. but it is lot's of fun to use!  Also has special code for the Macintosh "AV"
  618. series.
  619.  
  620.  
  621. "Phony" Mac Sound Trackers:
  622. The following programs have some limited capabilities that would be desirable
  623. in Sound Track/Sequancing software, but they do not save their constructed
  624. sequences to MOD (or any other music format).  If you like the features
  625. of these programs, it might be a good idea to pressure the authors to add
  626. MOD saving functionality, along with other sound-sequencing features.
  627.  
  628. Name            Vers    Author          Note
  629. -----           ----    -------         -----
  630. MultiTrack    1.0    Apple Comp.    Small prgram by "Kip, Neil & Hugh"
  631. DigiTrack    0.41    Mark Armantrout    Simmilar to "Mod Voicer"
  632. RapMaster    1.01    Bryan K.Ressler    Very Nice effects
  633. Canon 2        1.03    Glenn Anderson    Nice, simple interface
  634.  
  635.  
  636. Newest Macs:
  637. The Cyclone, and the smaller Tempest (Centris 660AV), represent 2 new Macs
  638. with enhanced sound capabilities (probabaly like the Atari Falcon, with it's
  639. DSP.. or the NeXT).. including 16 bit sounds at 44khz sampling (CD quality).
  640. A DSP also means the potential for "unlimited" sound channels, instead of just
  641. 4.. as well as built-in DMA.  This all makes for some pretty impressive music
  642. capabilities at very minimal impact on system performance/CPU time.
  643.  
  644. The Tempest stats: 25MHz 68040, 55MHz DSP 16bit colour, built-in DMA,
  645. one slot which can be made into a nubus slot.  Otherwise identical to the
  646. Quadra 840AV.  Pretty much the ideal Mac model for MOD playing, and can
  647. probably deliver sound comparable to an Amiga 4000 or Atari Falcon, for
  648. around $2000.
  649.  
  650. Old Macs:
  651. There is no MOD player for the older Macintoshes right now (any
  652. Mac without an "ASC" Chip.. i.e. Apple Sound Chip.)  This includes the
  653. Mac 128, Mac 512 ("Fat Mac"), Mac 512e, Mac Plus, or Mac SE.
  654. (I don't know if the Classic or Classic II can use the new Sound Manager,
  655. though the SE/030 and the Mac LC can, but probabaly with low quality.)
  656. There is, however, a commercial product that works on older Macs called
  657. "Studio Session" that produces files more or less just like MODs, but with
  658. 6 voices! (The Music for the games "Falcon" and "Tetris" for the Mac was
  659. produced with this program.)  It's interesting to realize that the Studio
  660. Session format has been around since about 1986 (2 years before the Amiga
  661. Sound Tracker was 1st written by Karsten Obarski).  The problem with the
  662. Studio Session File Format is that the music and instrument data are in
  663. seperate files.  A description of the Studio Session File formats follows:
  664.  
  665.  
  666. THE STUDIO SESSION SONG FILE FORMAT (Editor version 1.0)
  667. --------------------------------------------------------
  668. Format created by: Steve Capps <capps@applelink.apple.com>, Mark Zimmer,
  669. Tom Hedges, Ed Bogas, Nick Borelli, Ty Roberts, and Neil Cormia
  670. of Bogas Software in 1986.
  671.  
  672. This hacked-together description by: Jamal Hannah <jamal@gnu.ai.mit.edu>
  673.  
  674. There are 12 fields and 6 tracks to this format.. on old Macs, since you
  675. use complex waveforms for these sounds, you'll probabaly have to
  676. simulate the multiple sound channels by combining them on the fly
  677. with some fancy math.  I think there is actualy a Mac Toolbox call
  678. to do this in the origional "Sound Driver" chapter of Inside Macintosh.
  679.  
  680. File Signatures (Macintosh Only)
  681. Type:        'XSNG' (sometimes 'DSNG' or 'JSNG')
  682. Creator:    'XPRT'
  683.  
  684. Offset    Field        Length
  685. 0    Tempo        2    range: 10-450
  686. 2    unused        2    should be nul ($0000)
  687. 4    TimeSignature    2    decimal ranges of each byte: 1-32,1-32
  688. 6    Pascal string names of Instrument Files begin here, each followed
  689. by 2 nul bytes. ($00 $00)
  690. ??    unused        1    (should be $00.. if there are no instruments,
  691.                 this will come right after TimeSignature)
  692. ??    unused        64
  693. ??    Data for track 1, terminated by $B0
  694. ??    Data for track 2, terminated by $B0
  695. ??    Track 3  "
  696. ??    Track 4  "
  697. ??    Track 5  "
  698. ??    Track 6  "
  699.  
  700. Instruments are implicitly numbered from 01 onward, starting with the
  701. first one listed.  They are the exact name of the Studio Session
  702. Instrument file, which should be on the same volume or directory.
  703.  
  704. Track data consists of the following commands, which represent notes
  705. and other components on a musical staff:
  706.  
  707. COMMANDS (with fields and field names):
  708.  
  709. ending          $C0 xx (endingNumber)
  710. timeSignature    $BD xx xx (timeSigTop,timeSigBottom)
  711. barLine        $BA
  712. newInstrument    $B9 xxxx (instrumentNumber)
  713. dashedBarLine    $B5
  714. keySignature    $B4 xx (keyMode)
  715. tempoChange    $B3 xxxx (tempoSpeed)
  716. repeatBarEnd    $B2
  717. repeatBarStart    $B1 xxxx (numRepeats)
  718. coda        $B0
  719. musicalNote    xx xx xx  (pitch, unit#, slurStatus)
  720.  
  721. NOTE UNITS:
  722. A "musicalNote" is really either a rest, or a note. Normaly a unit is
  723. a rest, but if it has anything in the pitch field (mentioned above)
  724. then it is a note.  A rest always has $00 in the pitch and slurStatus
  725. fields.
  726.  
  727. unit32        $03    1/32nd rest or note
  728. unit32_3    $02    1/32nd rest or note triplet
  729. unit32_2    none
  730. unit32_1    none
  731. unit16        $06    1/16th rest or note
  732. unit16_3    $04    1/16th rest or note triplet
  733. unit16_2    none
  734. unit16_1    $09    1/16th rest or note, dotted
  735. unit8        $0C    1/8th rest or note
  736. unit8_3        $08    1/8th rest or note triplet
  737. unit8_2        $15    1/8th rest or note, double-dotted
  738. unit8_1        $12    1/8th rest or note, dotted
  739. unit4        $18    1/4th rest or note
  740. unit4_3        $10    1/4th rest or note triplet
  741. unit4_2        $2A    1/4th rest or note, double-dotted
  742. unit4_1        $24    1/4th rest or note, dotted
  743. unit2        $30    1/2 rest or note
  744. unit2_3        $20    1/2 rest or note triplet
  745. unit2_2        $54    1/2 rest or note, double-dotted
  746. unit2_1        $48    1/2 rest or note, dotted
  747. unit1        $60    Whole rest or note
  748. unit1_3        $40    Whole rest or note, triplet
  749. unit1_2        $A8    Whole rest or note, double-dotted
  750. unit1_1        $90    Whole rest or note, dotted
  751.  
  752. (A triplet is a rest/note with a little 3 over it, with playing length
  753. multiplied by 2/3 (shortened).  A double-dotted unit's length is multiplied
  754. by 1 3/4, and a single dotted unit length is multiplied by 1 1/2... if
  755. I am wrong, a good book on musical notation can clear this up!)
  756.  
  757. PITCH:
  758. Pitch values range from "C0" (lower C, at the bottom of the scale) up to
  759. "C6" (upper C, at the top of the scale).. and are represented by the
  760. numbers $01-$2B (1-43).
  761. Accidentals: If the pitch value has $40 added to it, then it is "flat".
  762. If it is "sharp", it has $80 added.
  763.  
  764. SLUR STATUS:
  765. The slur is that little curvy line that links two notes together and "slurs"
  766. them together at playtime.  Here are the byte values:
  767.  
  768. $00    No slur on this note
  769. $01    Slur start/line curving from this note toward one on the right
  770. $02    Slur end/line coming from a note to the left
  771. $03    Slur joint (two slur lines coming from both left and right)
  772.  
  773. (There are other codes that go here too.. sometimes a note has a little
  774. letter floating over it.  I still have yet to decode these variations.)
  775.  
  776. BAR LINE:
  777. This byte represents the vertical bar line that marks the end of a measure.
  778. I'm not sure what a dashed bar line is for!
  779.  
  780. ENDING:
  781. An "ending" command is followed by the number that the ending is repeated,
  782. ranging from 1-10 ($01-$0A)
  783.  
  784. REPEAT BAR:
  785. The Command byte is followed by a word-length number representing the number
  786. of times to repeat the following notes.  The repeated section is terminated
  787. by the next instance of a "repeatBarEnd" command.
  788.  
  789. TIME SIGNATURE:
  790. The "timeSignature" command is followed by bytes representing the top and
  791. bottom of the time signature, respectivly.
  792.  
  793. KEY SIGNATURE:
  794. The key signature command is followed by codes representing the following
  795. modes of the notes that follow:
  796.  
  797. Value    Key        Number to add to pitch-bytes of notes following
  798. $00    C Major        $00
  799. $01    G Major        $00
  800. $02    D Major        $80
  801. $03    A Major        $80
  802. $04    E Major        $80
  803. $05    B Major        $80
  804. $06    F Sharp Major    $80
  805. $07    C Sharp Major    $80
  806. $08    F Major        $00
  807. $09    B flat Major    $00
  808. $0A    E flat Major    $00
  809. $0B    A flat Major    $00
  810. $0C    D flat Major    $00
  811. $0D    G flat Major    $40
  812.             (note: dont add this value if the note already has
  813.             a sharp or a flat)
  814.  
  815. TEMPO CHANGE:
  816. A tempo change command byte is followed by a word-length value representing
  817. the new tempo speed, ranging (in decimal) from 10-450.
  818.  
  819. CODA
  820. A coda is a byte representing the end of a track.  If a track is empty,
  821. the coda byte holds it's place.  Since the file ends with the end of the
  822. 6th track, there will always be at least one $B0 at the end of the file.
  823.  
  824.  
  825. SUPER STUDIO SESSION SONG FILE FORMAT (Editor version 2.1)
  826. ----------------------------------------------------------
  827. The only real difference between verion 1 and 2 is the addition of two more
  828. tracks, for a total of eight.  The second two are represented just like
  829. the 1st six, with $B0 bytes as ending markers.  There is also one additional
  830. command:
  831.  
  832. VOLUME:
  833. The volume command is represented by (hex) byte $BF, with a word-length
  834. value following, and 3 bytes after that which I havn't figured out.
  835. Volume always defaults at "fff" (loudest).  "ppp" is the softest volume.
  836.  
  837. BF xxxx xx xx xx    Volume
  838.  
  839. BF 0000 58 88 9A    ppp
  840. BF 0001 12 40 80    pp
  841. BF 0002 12 40 80    p
  842. BF 0003 12 40 80    mp
  843. BF 0004 58 88 9A    mf
  844. BF 0005 12 40 80    f
  845. BF 0006 58 88 9A    ff
  846. BF 0007 58 88 9A    fff
  847.  
  848. Editor version 2 also places a (incremental) number above most bar lines,
  849. but this has nothing to do with the file format.
  850.  
  851.  
  852. (SUPER) STUDIO SESSION INSTRUMENT FILES (From Bogus Prod. Docs)
  853. ---------------------------------------------------------------
  854. The format of instrument files is very simple.  The samples are eight bit
  855. unsigned samples (silence =128).  There is an eight byte header with the
  856. following format followed by the samples themselves.  
  857.  
  858. No. Bytes    Description
  859.  
  860. 2        Loop Start: byte offset of loop start
  861. 2        Loop End:  byte offset of loop end
  862. 1        Recorded pitch:  #37 is middle C
  863. 1        0:  reserved
  864. 2        Length in bytes
  865. n        The samples
  866.  
  867. Note:  If loopback is used, there must be at least 370 samples after the
  868. loop end.
  869.  
  870. For more information, look at "Flute mid" in SoundEdit(tm) and then look at
  871. the binary version of the file with any file utility.
  872. Note:  some older files are compressed on disk so they won't follow the above
  873. description and some files have "0" for the pitch which implies middle C.
  874.  
  875. (Special Note: This file format is basicly the origional Macintosh "Sound Cap"
  876. and SoundEdit recorded instrument format (Type/Creator: 'DEWF'/'FSSC' or
  877. 'DEWF'/'SFX!') respectivly. - JH )
  878.  
  879. The SoundEdit manual has a good explanation of sampling techniques.
  880. SoundEdit will create Super Studio Session(tm) or Jam Session(tm) instrument
  881. files or convert them from most other formats.
  882.  
  883.  
  884.     Bogas Productions
  885.     751 Laurel Street, #213
  886.     San Carlos, California  94070
  887.     Phone:    (415) 592-5129
  888.     Fax:    (415) 592-5196
  889.  
  890. (April, 1992)
  891. ---
  892.  
  893.  
  894.